Initialize and configure the AgentIdentityClient for communicating with the SidClaw API.

AgentIdentityClient

The AgentIdentityClient is the main entry point for the SDK. It handles authentication, request retries, and communication with the SidClaw API.

Import

import { AgentIdentityClient } from '@sidclaw/sdk';

Constructor

const client = new AgentIdentityClient(config: ClientConfig);

ClientConfig

Property	Type	Required	Default	Description
`apiKey`	`string`	Yes	--	Your SidClaw API key (e.g., `sk_live_...`)
`apiUrl`	`string`	Yes	--	Base URL of the SidClaw API
`agentId`	`string`	Yes	--	The registered agent ID this client acts on behalf of
`maxRetries`	`number`	No	`3`	Maximum retries for transient failures (5xx and network errors)
`retryBaseDelayMs`	`number`	No	`500`	Base delay in milliseconds for exponential backoff

Example

import { AgentIdentityClient } from '@sidclaw/sdk';

const client = new AgentIdentityClient({
  apiKey: process.env.SIDCLAW_API_KEY!,
  apiUrl: 'https://api.sidclaw.com',
  agentId: 'ag_customer-support-bot',
});

Methods

The client exposes three methods:

Method	Description
`evaluate(action)`	Evaluate an action against the policy engine
`waitForApproval(id, options?)`	Poll for an approval decision
`recordOutcome(traceId, outcome)`	Record the result after executing an action

Retry Behavior

The client automatically retries requests that fail due to:

5xx server errors -- retried with exponential backoff and jitter
Network errors -- retried with exponential backoff and jitter
429 rate limit errors -- retried after the Retry-After header duration

Client errors (4xx other than 429) are not retried and throw immediately.

The backoff formula is:

delay = retryBaseDelayMs * 2^attempt * jitter

Where jitter is a random multiplier between 0.5 and 1.5.

Authentication

The client sends your API key in the Authorization header as a Bearer token on every request:

Authorization: Bearer sk_live_...

No additional authentication setup is required.

Python

SidClaw (sync)

from sidclaw import SidClaw

client = SidClaw(
    api_key="ai_...",
    base_url="https://api.sidclaw.com",  # default
    agent_id="your-agent-id",
)

AsyncSidClaw (async)

from sidclaw import AsyncSidClaw

async with AsyncSidClaw(
    api_key="ai_...",
    agent_id="your-agent-id",
) as client:
    decision = await client.evaluate({...})

Constructor Parameters

Parameter	Type	Required	Default	Description
`api_key`	`str`	Yes	--	Your SidClaw API key (e.g., `ai_...`)
`base_url`	`str`	No	`https://api.sidclaw.com`	Base URL of the SidClaw API
`agent_id`	`str`	Yes	--	The registered agent ID this client acts on behalf of
`max_retries`	`int`	No	`3`	Maximum retries for transient failures (5xx and network errors)
`timeout`	`float`	No	`30.0`	Request timeout in seconds

Methods

The Python client exposes the same three methods:

Method	Description
`evaluate(action)`	Evaluate an action against the policy engine
`wait_for_approval(id, **options)`	Poll for an approval decision
`record_outcome(trace_id, outcome)`	Record the result after executing an action

The AsyncSidClaw client provides async versions of all methods and supports use as an async context manager.

Framework Integrations

The AgentIdentityClient is the foundation for all SidClaw integrations. For framework-specific wrappers, see:

NemoClaw — governNemoClawTools() for NVIDIA NemoClaw sandboxes
MCP — GovernanceMCPServer proxy for any MCP server
LangChain — governTools() wraps LangChain tool arrays
OpenAI Agents — governOpenAITool() for function tools
All integrations — Complete list

Client

On this page